home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Comm / yam / YAMGenesis.lha / YAMGenesis / YAMGenesis.doc < prev    next >
Text File  |  2004-06-09  |  9KB  |  225 lines
  1.  
  2.                           GenesisOnline.yam
  3.                           GenesisOffline.yam
  4.                           GenesisQuit.yam
  5.  
  6.                         Version 1.08 - 9.6.04
  7.  
  8.                            © H. van der Ree
  9.                            hivdree@uwnet.nl
  10.  
  11.  
  12. Are you using an expensive dailupline to your ISP? Do you want to keep the
  13. costs as low as possible when emailing or doing news? These arexx scripts
  14. keep the time you are connected to an absolute minimum!
  15.  
  16. They combine getting online, sending new mail and optionally news,
  17. downloading new mail and optionally new news, go offline and optionally scan
  18. your new email for YahooGroups adverts under the 'Get' and "Send' buttons.
  19.  
  20. Of course you can use these scripts to simply send and receive email
  21. AND news with YAM too, without the online-offline bit.
  22.  
  23.  
  24. DESCRIPTION:
  25.  
  26. GenesisOnline.yam will start and put Genesis online from YAM before
  27. sending and downloading new mail and news.
  28.  
  29. GenesisOffline.yam optionally starts YAM2NN by Karol Bryd & Magnus
  30. Johansson, disconnects Genesis from your server, and if installed starts
  31. YahooGroupsScanner.rexx by Steve Bowman.
  32. Get them from Aminet, comm/mail/YahooGpScan1_2.lha.
  33.                       comm/news/Yam2NN_0.87.lha
  34. If mail is send it will also check if there is new mail on your mailserver
  35. and download it before hanging up if the option "SEND" is used.
  36. If you use Yam2NN the same goes for news, both sending and downloading!
  37.  
  38. The connection will not be touched if other programs like browsers or FTP
  39. clients are running or Genesis was already online. The latter can be
  40. overruled with the option "CLOSE".
  41.  
  42. GenesisQuit.yam cleans up when you quit YAM.
  43.  
  44.  
  45. REQUIREMENTS:
  46.  
  47. Genesis, YAM 2 and REXX. Optionally YahooGroupsScanner.rexx and YAM2NN for
  48. stripping YahooGroups adverts and NNTP support.
  49.  
  50. rexxdossupport.library, Copyright (C) 1994-1997 by hartmut Goebel,
  51.                         included in this archive.
  52. WBStarter      ; \
  53. wbstart.library;  >---- Copyright (C) 1991-96 Stefan Becker, included in
  54. dospath.library; /      this archive.
  55.  
  56. For OS3.5 and OS3.9 you can replace these with the relevant files from
  57. WBStartEmu.lha. If you do use version 45.1c or better, lower versions don't
  58. work for scripts!
  59. If you use OS3.9 with BB1 and BB2, use WBRun from BB2, NOT WBStartEMU!!
  60.  
  61. Get the latest WBStartEMU from
  62.   http://home.wtal.de/stephanr/downloads/WBStartEmu.lha
  63.  
  64. The scripts work with Genesis 1.0.6, GenesisRA, YAM 2.1, YAM 2.2, YAM 2.3,
  65. OS 3.1 and OS 3.9. Other versions are not tested but should work.
  66.  
  67.  
  68. INSTALLATION:
  69.  
  70. ===========================================================================
  71.  
  72. IMPORTANT:   Change the GenesisOnline.yam script so it uses the Genesis
  73.              path and interface you use!
  74.              The name for the interface is the IfName item in
  75.              genesis.config.
  76.              Look for genesis.config in AmiTCP:db/.
  77.  
  78. ===========================================================================
  79.  
  80. To install, simply copy these scripts to YAM:Rexx. You don't need the .deb
  81. versions. Only use those if you have problems running the scripts.
  82. Copy the programs from the c-directory to c: and from libs-directory to
  83. Libs: Make sure you do not overwrite newer existing files!
  84. wbstart.library is an OS3.1 library, if you are using OS3.5 or OS3.9 get
  85. the latest WBStartEmu.lha from
  86.    http://home.wtal.de/stephanr/downloads/WBStartEmu.lha.
  87.  
  88. If you are using OS3.9 with BB1 AND BB2 do NOT replace WBRun 45.7 from BB2
  89. with the version from WBStartEMU! Read the note inside the WBStartEMU
  90. archive!
  91.  
  92. If you use WBStartEmu then replace 'wbstarter' by 'wbrun' in
  93. GenesisOnline.yam.
  94.  
  95. * Now open YAM's Config panel and go to the ARexx section. Hilite the
  96.   "Before getting mail" item and load "Rexx/GenesisOnline.yam" into the
  97.   Script gadget. Double check the Pop-up selector is on ARexx and not
  98.   AmigaDOS. Leave "Open console window" unchecked, but (IMPORTANT) make
  99.   sure "Wait for termination" is checked ON.
  100.  
  101.   If you want to be asked if an already open connection should be closed
  102.   by YAM, add the option "CLOSE"
  103.  
  104. * Hilite the "After getting mail" item and load "Rexx/GenesisOffline.yam"
  105.   into the Script gadget. Double check the Pop-up selector is on ARexx and
  106.   not AmigaDOS. Leave "Open console window" unchecked, but (IMPORTANT) make
  107.   sure "Wait for termination" is checked ON.
  108.  
  109.   If you want YAM2NN support add the option "NEWS". Don't forget to add
  110.   "SYS:Rexxc/rx YAM:Rexx/GenesisOffline.yam" into the "After download"
  111.   gadget on the events page of YAM2NNConfig!
  112.  
  113. * Hilite the "Before sending mail" item and load "Rexx/GenesisOnline.yam"
  114.   into the Script gadget. Double check the Pop-up selector is on ARexx and
  115.   not AmigaDOS. Leave "Open console window" unchecked, but (IMPORTANT) make
  116.   sure "Wait for termination" is checked ON.
  117.  
  118.   If you use Yam2NN add the option "NEWS". This option checks for news and
  119.   if found marks it 'H' so it is not send the 'normal' way. After your mail
  120.   is send the original status is restored and your news is send by Yam2NN.
  121.  
  122.   Email-on-hold is not affected. Because Yam2NN doesn't yet support the
  123.   YAM mailstatus, news-on-hold is send together with the other news!!
  124.   GenesisOnline.yam does however support news-on-hold.
  125.  
  126.   If you want to be asked if an already open connection should be closed by
  127.   YAM, add the option "CLOSE"
  128.  
  129. * Hilite the "After sending mail" item and load "Rexx/GenesisOffline.yam
  130.   SEND" into the Script gadget. Don't forget the option 'SEND'. Double
  131.   check the Pop-up selector is on ARexx and not AmigaDOS. Leave
  132.   "Open console window" unchecked, but (VERY IMPORTANT) make sure "Wait for
  133.   termination" is checked OFF.
  134.  
  135. * Hilite the "Program termination" item and load "Rexx/GenesisQuit.yam"
  136.   into the Script gadget. Double check the Pop-up selector is on ARexx and
  137.   not AmigaDOS. Leave "Open console window"  and "Wait for termination"
  138.   unchecked.
  139.  
  140. Save your new settings. From now on you only have to start YAM to use your
  141. email!
  142.  
  143.  
  144. USAGE:
  145.  
  146. Not much to say really.
  147.  
  148. Press 'Get' if you want to download new mail and optionally news.
  149.  
  150. Press 'Send' if you have new mail or news to send and automatically your
  151. new mail and optionally new news will be downloaded as well.
  152.  
  153.  
  154. BUGS:
  155.  
  156. None that I know off.
  157.  
  158. If you have problems running these scripts, replace them with the .deb
  159. versions and see if the file RAM:GenesisOnline.debug means anything to you.
  160. If it doesn't send this file together with a description of the problem and
  161. a summary of your system to me and I will try to find an answer.
  162.  
  163. Don't forget to change the GenesisOnline.yam.deb script so it uses the
  164. Genesis path and interface you use!
  165.  
  166.  
  167. HISTORY:
  168.  
  169.   1.00 - 08.11.00  First public version.
  170.   1.01 - 09.11.00  Added a note about YAM2NNConfig in YAMGenesis.doc.
  171.                    The scripts did not change.
  172.   1.02 - 01.03.01  Added GenesisQuit.yam script and removed all 'screen'-
  173.                    stuff. Genesis will use the same screen as YAM.
  174.                    It now uses YahooGroupsScanner.rexx.
  175.   1.03 - 04.05.01  GenesisOnline.yam:
  176.                      Added check for rexxsupport.library.
  177.                      Added support for auto-online interfaces.
  178.                    All scripts where made to work with OS3.9!
  179.                    Added debug versions of the scripts.
  180.                    Updated this doc file.
  181.   1.04 - 07.05.01  You can now send news with Yam2NN!
  182.                    GenesisOnline.yam:
  183.                      Added support for sending news with Yam2NN.
  184.                    GenesisOffline.yam:
  185.                      Added support for sending news with Yam2NN.
  186.                    Again updated the doc file.
  187.   1.05 - 05.06.01  GenesisOnline.yam:
  188.                      Added pubscreen support, after starting GenesisRA
  189.                      get YAM-screen back in front!
  190.                    Other scripts did not change.
  191.   1.06 - 07.08.01  GenesisOnline.yam:
  192.                      Added CLOSE option; ask if already open connection
  193.                      should be closed by YAM.
  194.                    Other scripts did not change.
  195.   1.07 - 21.10.01  GenesisOnline.yam:
  196.                      Changed argument parsing.
  197.                    Other scripts did not change.
  198.   1.08 - 09.06.04  GenesisOnline.yam:
  199.                      Added 'DontAskAgain' option to requester.
  200.                    GenesisQuit.yam:
  201.                      Added support for 'DontAskAgain'.
  202.                    Other scripts did not change.
  203.  
  204.  
  205. THANKS
  206.  
  207. Thanks go to Steve Bowman, I nicked parts of his eGroupsScanner.readme.
  208. I hope he doesn't mind.
  209. Thanks also to Marcel Beck, of course for YAM, and the MiamiOn & Offline
  210. scripts which inspired me to write these Genesis scripts.
  211. A big thanks to Johan Banis for his time and effort to make these scripts
  212. work on other systems than mine, in particular under OS3.9 and with Yam2NN.
  213.  
  214. DISCLAIMER:
  215.  
  216. · These scripts are to be used entirely at your own risk, and although I
  217.   have performed extensive testing, I will not be held responsible for any
  218.   loss of data as a result of there use.
  219. · These scripts are © 2000-2004, and may only be distributed in its
  220.   original unmodified form.
  221. · These scripts are EMailware, that means if you use them, please send me
  222.   an email.
  223.  
  224. If you disagree with any of the above, do not use the scripts!
  225.